home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 3 / Amiga Format CD03 (1996-07-04)(Future Publishing)(GB)(Track 1 of 6)[!][issue 1996-08].iso / comms / netsoftware / amigafaces.lha / faces.man < prev    next >
Text File  |  1994-12-11  |  3KB  |  102 lines
  1. AmigaFaces                                AmigaFaces
  2.  
  3.  
  4. NAME
  5.  
  6.     AmigaFaces 1.0 - Universal mail notifier for UUCP and SMTP
  7.         Systems (in.smtpd or InetUtils v1.4)
  8.  
  9. SYNOPSIS
  10.  
  11.     faces
  12.  
  13. DESCRIPTION
  14.  
  15.     AmigaFaces is a program to be used as a mail filter. It can
  16.     start other programs depending on the incoming mail's sender.
  17.     Thus, you can i.e. let your Amiga sing "Halleluhjah" whenever
  18.     a mail from your girlfriend arrives or swear loudly when mail
  19.     from the company is received.
  20.     
  21.  
  22. INSTALLATION
  23.  
  24.     Copy faces somewhere in your search path. Copy faces.db to
  25.     AmiTCP:db, UULib: or S:. If you don't have one of these, you
  26.     don't have an Amiga. AmigaFaces is not for you.
  27.     
  28.     Change faces.db to suit your needs. (This file is well
  29.     commented and should be pretty self-explanatory.
  30.  
  31.     Edit your aliases file, most propably UULib:aliases or
  32.     AmiTCP:db/aliases. For every user whose mail shall be
  33.     processed by faces, add a piping entry. Example:
  34.  
  35.     foo: \foo, "|faces"
  36.  
  37.     For the ones without a sound collection of their own I have
  38.     included a "Halleluhjah" and a "DingDing" sound to have
  39.     something to start with. I strongly recommend AmiSOX, which
  40.     can be found on Aminet and converts virtually all formats to
  41.     Amiga IFF (8svx) sound.
  42.  
  43.     That's all.
  44.  
  45.  
  46. NOTES
  47.  
  48.     The way this program works is easy: It is invoked by the
  49.     rmail-type part of your mailsytem and is given the mail as
  50.     its input. It extracts the sender's EMail-address and then
  51.     looks up faces.db to see if an action is defined for this
  52.     address or class of addresses. If one was found, faces
  53.     performs the corresponding action.
  54.  
  55.     See the example faces.db for additional documentation.
  56.  
  57.  
  58. DISCLAIMER
  59.  
  60.     No cost - no warranty. Although I really can't imagine what
  61.     harm the proper or improper usage of AmigaFaces could do to
  62.     your system or data integrity, I must, of course, deny any
  63.     responsibility for incidetal or consequential damages 
  64.     whatsoever. Smile. Relax. Enjoy.
  65.  
  66.     AmigaFaces, that is all part of this distribution except for
  67.     the sounds, is Copyright 1994 by Andreas Oesterhelt. All
  68.     rights are strictly reserved. Permission is granted to
  69.     distribute and use, AS LONG AS NO PROFIT IS MADE HEREOF.
  70.     Violators will be towed ;-)
  71.  
  72.     The author can be reached on the net as oesi@paradis.rhein.de
  73.     I would be glad about your comments, greetings, curses, etc.
  74.  
  75.  
  76.  
  77. BUGS/TODO
  78.     
  79.     I have extensively tested faces with AmigaUUCP rmail, the
  80.     in.smtpd for AmiTCP 3b and shortly with SMTPd fom InetUtils
  81.     1.4. So far, no bugs are known.
  82.  
  83.     I am thinking about adding a switch for the faces.db entries
  84.     that will make piping the mailbody to a command possible. Thus
  85.     one could i.e. have messages from selected people displayed 
  86.     without entering one's mailreader.
  87.  
  88.     Also, the matching of the sender's name should become case-in-
  89.     sensitive.
  90.  
  91.     If requested, different db files for different users are
  92.     imaginable.
  93.  
  94.  
  95. DIAGNOSTICS
  96.  
  97.     To test your faces.db without requesting hundreds of people to
  98.     send mail, you can invoke faces from the command line and then
  99.     type in a From: line, terminated by Ctrl-\ (EOF). Faces will
  100.     try to execute the predefined action and errors of either
  101.     faces or the invoked application are displayed in the shell.
  102.